# -*- encoding : utf-8 -*-
# See http://unicorn.bogomips.org/examples/unicorn.conf.minimal.rb for a much simpler configuration file.
# See http://unicorn.bogomips.org/Unicorn/Configurator.html for complete documentation.
# Or the base http://unicorn.bogomips.org/

# paths and things
# 在这里修改为项目所在目录
wd          = File.expand_path('../../', __FILE__)
development = ENV["RACK_ENV"] == 'development'
tmp_path    = File.join(wd, 'tmp')
socket_path = File.join(tmp_path, 'sockets/unicorn.sock')
pid_path    = File.join(tmp_path, 'unicorn.pid')
err_path    = File.join(tmp_path, 'unicorn.error.log')
out_path    = File.join(tmp_path, 'unicorn.out.log')

# Use at least one worker per core if you're on a dedicated server,
# more will usually help for _short_ waits on databases/caches.
# 如果你是在专用服务器上，一个cpu核上至少要运行一个worker
worker_processes 2

# Since Unicorn is never exposed to outside clients, it does not need to
# run on the standard HTTP port (80), there is no reason to start Unicorn
# as root unless it's from system init scripts.
# If running the master process as root and the workers as an unprivileged
# user, do this to switch euid/egid in the workers (also chowns logs):
# user "unprivileged_user", "unprivileged_group"

# tell it where to be
working_directory wd

# listen on both a Unix domain socket and a TCP port,
# we use a shorter backlog for quicker failover when busy
if development
  listen 8080, :tcp_nopush => true #坚挺具体端口可以直接通过 http://localhost:8080访问应用，此时不会经过nginx。
else
  # unix domain socket会比tcp socket快，而且节约端口，不过小应用来讲，快的可以忽略不计
  # socket文件是由unicorn创建，而不是手动创建，也就是说运行unicorn的进程应当对log目录有写权限，777不是一个好习惯，生产环境要谨慎
  # nginx与unicorn配合的大概的原理是：外部请求进来，nginx会匹配，然后把请求转发给对应的upstream，这里就是unicorn，然后unicorn承载的rails app处理请求之后返回结果给请求者，nginx只是作为一个中间人存在，这也就是为啥管他叫反向代理的原因
  listen socket_path, :backlog => 16 # ngix配置会用到socket_path对应的地址
end


# nuke workers after 30 seconds instead of 60 seconds (the default)
# request 超时时间，超过此时间则自动将此请求杀掉，单位为秒
timeout 30

# feel free to point this anywhere accessible on the filesystem
# pid文件的位置，可以自己设置，注意权限,　每次　unicorn　服务器启动后，会产生 pid进程号，记录在　unicorn.pid 文件中了
# 停止或重启　unicorn　服务时，会读取这个文件中记录的进程号，kill掉，然后产生新的进程号，并重新写到文件中
pid pid_path

# By default, the Unicorn logger will write to stderr.
# Additionally, ome applications/frameworks log to stderr or stdout,
# so prevent them from going to /dev/null when daemonized here:
stderr_path err_path  #错误日志的位置，自己设置，注意权限
stdout_path out_path  #输出日志的位置，自己设置，注意权限


# combine Ruby 2.0.0dev or REE with "preload_app true" for memory savings
# http://rubyenterpriseedition.com/faq.html#adapt_apps_for_cow
preload_app false

GC.respond_to?(:copy_on_write_friendly=) and
    GC.copy_on_write_friendly = true

# Enable this flag to have unicorn test client connections by writing the
# beginning of the HTTP headers before calling the application.  This
# prevents calling the application for connections that have disconnected
# while queued.  This is only guaranteed to detect clients on the same
# host unicorn runs on, and unlikely to detect disconnects even on a
# fast LAN.
check_client_connection false

before_fork do |server, worker|
  # the following is highly recomended for Rails + "preload_app true"
  # as there's no need for the master process to hold a connection
  defined?(ActiveRecord::Base) and
      ActiveRecord::Base.connection.disconnect!

  # The following is only recommended for memory/DB-constrained
  # installations.  It is not needed if your system can house
  # twice as many worker_processes as you have configured.
  #
  # # This allows a new master process to incrementally
  # # phase out the old master process with SIGTTOU to avoid a
  # # thundering herd (especially in the "preload_app false" case)
  # # when doing a transparent upgrade.  The last worker spawned
  # # will then kill off the old master process with a SIGQUIT.
  old_pid = "#{server.config[:pid]}.oldbin"
  if old_pid != server.pid
    begin
      sig = (worker.nr + 1) >= server.worker_processes ? :QUIT : :TTOU
      Process.kill(sig, File.read(old_pid).to_i)
    rescue Errno::ENOENT, Errno::ESRCH
    end
  end
  #
  # Throttle the master from forking too quickly by sleeping.  Due
  # to the implementation of standard Unix signal handlers, this
  # helps (but does not completely) prevent identical, repeated signals
  # from being lost when the receiving process is busy.
  # sleep 1
end

after_fork do |server, worker|
  # per-process listener ports for debugging/admin/migrations
  # addr = "127.0.0.1:#{9293 + worker.nr}"
  # server.listen(addr, :tries => -1, :delay => 5, :tcp_nopush => true)

  # the following is *required* for Rails + "preload_app true",
  defined?(ActiveRecord::Base) and
      ActiveRecord::Base.establish_connection

  # if preload_app is true, then you may also want to check and
  # restart any other shared sockets/descriptors such as Memcached,
  # and Redis.  TokyoCabinet file handles are safe to reuse
  # between any number of forked children (assuming your kernel
  # correctly implements pread()/pwrite() system calls)
end
